home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / psrip.z / psrip
Encoding:
Text File  |  2002-10-03  |  36.7 KB  |  727 lines

  1.  
  2.  
  3.  
  4. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      psrip - convert a PostScript file to raster data format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppssssrrrriiiipppp [----OOOO filename] [----LLLL filename] [----PPPP printer_name]
  13.            [----FFFF format] [----BBBB bits]
  14.            [----CCCC colorspace] [----dddd device_type[arg1,[arg2]]]
  15.            [----WWWW width] [----HHHH height]
  16.            [----RRRR res] [----XXXX hres] [----YYYY vres]
  17.            [----UUUU hoff] [----VVVV voff] [----IIII filename]
  18.            [----GGGG arg1,[arg2,[arg3,[arg4]]] [----TTTT]
  19.            [----jjjj pixels] [----ffff] [----rrrr angle] [----llll] [----kkkk]
  20.            [----vvvv] [----MMMM] [----SSSS] [----gggg scratch_dir]
  21.            [----yyyy persistent_dir] [----aaaa startup_path]
  22.            [----bbbb backend_path] [----cccc resource_path]
  23.            [----oooo backend option] [----xxxx] [----hhhh] [----DDDD[[[[[[[[DDDD]]]]DDDD]]]]]
  24.            [PostScript input file]
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _p_s_r_i_p is a PostScript Level 2 interpreter with Adobe CPSI. _p_s_r_i_p converts
  28.      a PostScript file into TIFF compatible raster output for use by printer
  29.      drivers. This program supersedes the _p_s_r_i_p level 1 program which used
  30.      Display Postscript.
  31.  
  32.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  33.      By default, _p_s_r_i_p assumes that its input will be arriving on the standard
  34.      input, its output should be written to the standard output and error
  35.      messages should be written to the standard error.  If a filename is
  36.      specified after all option switches, data will be read from that file
  37.      rather than from the standard input.
  38.  
  39.      ----OOOO _f_i_l_e_n_a_m_e
  40.                Specifies the name of the file to which the rasterized output
  41.                will be sent.  If the ----OOOO option is not specified, output will
  42.                be sent to the standard output.
  43.  
  44.      ----LLLL _f_i_l_e_n_a_m_e
  45.                Specifies the name of the file to which error, warning and
  46.                informational messages are to be written.  If the file
  47.                specified already exists, any messages generated by _p_s_r_i_p will
  48.                be appended to the end of the file.  If the ----LLLL option is not
  49.                specified, message output will be sent to standard error.
  50.  
  51.      ----PPPP _p_r_i_n_t_e_r__n_a_m_e
  52.                Specifies the name of the printer for which raster output is to
  53.                be generated.  _p_r_i_n_t_e_r__n_a_m_e is the name of a printer that is
  54.                physically attached to the system running _p_s_r_i_p. The printer
  55.                name is used to locate the Printer Object Database (POD) for
  56.                the printer (see _l_i_b_p_o_d(_3)). If this option is specified, the
  57.                printer specific values for output width, length, and
  58.                resolution are filled in from the POD and need not be specified
  59.                using command-line options. Use of the ----PPPP option is preferable
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  71.  
  72.  
  73.  
  74.                to manually setting the options because changes to the printer
  75.                configuration file will then be reflected in the program's
  76.                output. The values read from the POD file can be selectively
  77.                overridden using the command-line options.  If POD values must
  78.                be overridden, specify the overriding options after (to the
  79.                right of) the ----PPPP option, since the rightmost option takes
  80.                precedence.
  81.  
  82.                For compatibility with previous releases of the _I_m_p_r_e_s_s_a_r_i_o
  83.                product, the ----PPPP option can take a full pathname to the POD
  84.                files instead of a printer name. _p_s_r_i_p automatically detects
  85.                that a complete pathname has been specified and looks for the
  86.                POD files in the directory specified by that pathname. The use
  87.                of full POD pathnames is discouraged.
  88.  
  89.      ----FFFF _f_o_r_m_a_t Specifies the output raster data format. _f_o_r_m_a_t may be
  90.                specified as cccchhhhuuuunnnnkkkkyyyy, or the default, ppppllllaaaannnnaaaarrrr. The data format is
  91.                normally derived from the POD (see ----PPPP), which is kept up to
  92.                date with the current printer configuration.
  93.  
  94.                Chunky data is organized such that the color values for each
  95.                dot appear together.  For example, if a dot consists of three
  96.                colors C, M and Y, chunky output format for a 3 dot by 3 dot
  97.                image would be organized as:
  98.  
  99.  
  100.                CMYCMYCMY
  101.                CMYCMYCMY
  102.                CMYCMYCMY
  103.  
  104.                Note that for the case of one bit per component, the chunky
  105.                data above would contain a trailing 0 to nibble align each
  106.                pixel's data (i.e. CMY0CMY0CMY0). Depths greater than one bit
  107.                per component pack the data (i.e. CMYCMYCMY).
  108.  
  109.                Planar data is organized such that all data for one color
  110.                component is output followed by all data for the next color
  111.                component and so on. For example, the CMY data in the above
  112.                example organized for planar output would appear as:
  113.  
  114.  
  115.                CCC
  116.                CCC
  117.                CCC
  118.                MMM
  119.                MMM
  120.                MMM
  121.                YYY
  122.                YYY
  123.                YYY
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  137.  
  138.  
  139.  
  140.                The selection of output data organization for single component
  141.                colorspaces is moot. Therefore, when the kkkk or wwww colorspace is
  142.                specified, the ----FFFF switch is ignored and by convention the
  143.                output is considered to be in cccchhhhuuuunnnnkkkkyyyy format.
  144.  
  145.      ----BBBB _b_i_t_s   Specifies the number of bits per color component for the output
  146.                data.  Currently, _b_i_t_s may be specified as 1111, the default, 4444,
  147.                or 8888.  The bits per color is normally derived from the POD (see
  148.                ----PPPP), which is kept up to date with the current printer
  149.                configuration.
  150.  
  151.      ----CCCC _c_o_l_o_r_s_p_a_c_e
  152.                Specifies the output data colorspace. The standard values of
  153.                _c_o_l_o_r_s_p_a_c_e may be one of the following: kkkk, the default, wwww
  154.                (inverse k), ccccmmmmyyyy, ccccmmmmyyyykkkk, yyyymmmmcccc, yyyymmmmcccckkkk, kkkkccccmmmmyyyy, or rrrrggggbbbb.  These values
  155.                will all produce TIFF compatible output organized according to
  156.                the ----FFFF option with a depth per color component specified by the
  157.                ----BBBB option.
  158.  
  159.      ----ZZZZ _c_o_m_p_r_e_s_s_i_o_n
  160.                Specifies the compression scheme to be used on the output data.
  161.                Currently, compression is not supported.
  162.  
  163.      ----WWWW _w_i_d_t_h, ----HHHH _h_e_i_g_h_t
  164.                The ----WWWW and ----HHHH options specify the output data area in dots, in
  165.                the horizontal (width) and vertical (height) directions,
  166.                respectively.  These values are normally derived from the POD
  167.                (see ----PPPP), which is kept up to date with the currently loaded
  168.                paper size. The default width and height correspond to an 8.5
  169.                by 11 inch output area rendered at 100 dots per inch (dpi).
  170.                Therefore, the default output area is:
  171.  
  172.  
  173.                default width = 850 dots
  174.                default height = 1100 dots
  175.  
  176.      ----RRRR _r_e_s, ----XXXX _h_r_e_s, ----YYYY _v_r_e_s
  177.                The ----RRRR option specifies the printer resolution in dots per inch
  178.                in the horizontal (width) and vertical (height) directions
  179.                simultaneously.  These values may be set independently using
  180.                the ----XXXX (for width) and ----YYYY (for height) options.  These values
  181.                are normally derived from the POD (see ----PPPP), which is kept up to
  182.                date with the current printer configuration. The default
  183.                horizontal and vertical resolutions are 100 dots per inch.
  184.                There is no maximum resolution limitation.
  185.  
  186.      ----UUUU _h_o_f_f, ----VVVV _v_o_f_f
  187.                These options specify the horizontal (x) and vertical (y)
  188.                offsets of the frame buffer origin in dots, respectively.
  189.                These options may be used to adjust the PostScript origin to
  190.                compensate for image clipping and should be used with care. The
  191.                default horizontal and vertical offsets are zero. Note that
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  203.  
  204.  
  205.  
  206.                these offset are relative to the page and are not effected by
  207.                image rotation or flipping.
  208.  
  209.      ----IIII _f_i_l_e_n_a_m_e
  210.                It is often necessary to prepend PostScript code onto a
  211.                PostScript file before it can be properly interpreted.
  212.                Typically this prolog code consists of PostScript functions and
  213.                definitions that will be referenced by the main PostScript
  214.                file. Often the prolog is concatenated onto the beginning of
  215.                the main file and the result is interpreted as a single file.
  216.                The _p_s_r_i_p program provides a more efficient means for
  217.                prepending prolog files.  The ----IIII flag allows a prolog file to
  218.                be included for processing before the main PostScript file.
  219.                Multiple ----IIII flags can be specified on the command-line. The
  220.                files will be processed from left to right in the order
  221.                specified.
  222.  
  223.      ----TTTT        At present this option performs no function in the level 2 rip.
  224.                There is a default screen installed with the rip which can only
  225.                be overridden by Postscript screen/halftone commands. It is not
  226.                clear what purpose, if any, this option may perform in the
  227.                future.
  228.  
  229.                Since halftoning is a device dependent operation the default
  230.                halftone may not produce adequate results on certain output
  231.                devices. Under these circumstances it may be necessary to
  232.                define a new PostScript halftone cell and prepend this
  233.                definition to the input file as a PostScript prolog. Please
  234.                refer to the "_P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l" for
  235.                information on halftone cells. Refer to the ----IIII switch for
  236.                information on prolog files.
  237.  
  238.      ----GGGG _r_e_d__g_a_m_m_a,[_g_r_e_e_n__g_a_m_m_a,[_b_l_u_e__g_a_m_m_a,[_g_r_a_y__g_a_m_m_a]]]
  239.                Specifies gamma values that will be applied before the current
  240.                job is executed. This option is realized via the Postscript
  241.                setcolortransfer operator. The red_gamma is applied to the
  242.                red/cyan color plane, the green_gamma is applied to the
  243.                green/magenta color plane, the blue_gamma is applied to the
  244.                blue/yellow color plane, and the gray_gamma to any black or
  245.                gray color plane.  The default value, no gamma correction
  246.                (1.0), will be applied to any planes which are not specified
  247.                via the command line. Please note that one must specify all the
  248.                gamma values to specify a gray gamma value. Each gamma value is
  249.                interpreted as a floating point number.
  250.  
  251.      ----ffff        Specifies that the output image should be flipped (mirrored)
  252.                about the vertical axis. This flag is useful when creating
  253.                transparencies.  Note that flipping of the image is performed
  254.                after any rotation. Therefore, the image is always flipped
  255.                about the vertical axis.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  269.  
  270.  
  271.  
  272.      ----rrrr _a_n_g_l_e  Specifies that the image is to be rotated by _a_n_g_l_e degrees.
  273.                Positive rotations are counter-clockwise measured from the
  274.                horizontal axis.  The default rotation angle is 0. _a_n_g_l_e may be
  275.                any positive or negative integer. Only angles which are a
  276.                multiple of 90 degrees are supported.  Specified angles that
  277.                are not multiples of 90 degrees are snapped to the nearest
  278.                multiple of 90 degrees.
  279.  
  280.      ----llll        Specifies that the output should be in landscape orientation
  281.                rather than portrait. Note that specifying this option simply
  282.                creates the raster imaging framebuffer with the page width and
  283.                height values swapped.  It is the responsibility of the
  284.                PostScript input code to operate correctly in a landscape
  285.                orientation. It may be necessary to specify an image rotation
  286.                using the ----rrrr switch and a frame buffer offset using the ----UUUU and
  287.                ----VVVV switches in order to obtain the desired landscape results.
  288.  
  289.      ----MMMM        The psrip program has two methods for allocating raster buffer
  290.                storage. The back end DSO must define raster buffer allocation
  291.                and deallocation functions that are used as callbacks by CPSI
  292.                for raster buffer memory management. If the ----MMMM option is
  293.                specified raster buffer allocation will be made by memory
  294.                mapping a temporary disk file. This tends to improve
  295.                performance when a large frame device is used (see the ----dddd
  296.                option). The ----MMMM option only takes effect when the device type
  297.                is a frame device. The temporary file is created in the
  298.                interpreter scratch file directory (see the ----gggg option). The
  299.                size of the temporary file will be equal to the amount of
  300.                storage required for the raster buffer rounded up to the
  301.                nearest memory page. For a frame device this can lead to a very
  302.                large file. The temporary file is automatically removed by
  303.                psrip.
  304.  
  305.      ----SSSS        A standard PostScript document will use a sssshhhhoooowwwwppppaaaaggggeeee operator
  306.                between each page. The sssshhhhoooowwwwppppaaaaggggeeee operator instructs the
  307.                interpreter to output the current raster image. Typically,
  308.                Encapsulated PostScript files do not contain a sssshhhhoooowwwwppppaaaaggggeeee
  309.                operator. The ----SSSS switch forces the execution of a sssshhhhoooowwwwppppaaaaggggeeee
  310.                operator at the end of the PostScript file if a sssshhhhoooowwwwppppaaaaggggeeee has
  311.                never been issued by the file. If the file has issued a
  312.                sssshhhhoooowwwwppppaaaaggggeeee this switch has no effect. If a syntactically correct
  313.                PostScript file does not produce an output image, the ----SSSS flag
  314.                may be specified to force a single page output.
  315.  
  316.  
  317.      ----dddd ddddeeeevvvviiiicccceeeeTTTTyyyyppppeeee[[[[,,,,aaaarrrrgggg1111[[[[,,,,aaaarrrrgggg2222]]]]]]]]
  318.                Specifies how raster image data should be fed from the
  319.                interpreter kernel to the back end DSO. The available values of
  320.                deviceType are described below. The default device type is
  321.                auto. Note that certain values of deviceType accept optional
  322.                arguments (i.e. arg1 and arg2).
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  335.  
  336.  
  337.  
  338.      _n_u_l_l      Specifies that no raster image is to be produced. No raster
  339.                buffer storage is allocated and the show, stroke, show page and
  340.                copypage operators do nothing. However, all other aspects of
  341.                interpreting the page description proceed normally. The best
  342.                use of this option is to check a PostScript page description
  343.                for syntactical or resource allocation errors, so called
  344.                preflighting.
  345.  
  346.  
  347.      _f_r_a_m_e     Specifies that a frame device should be used for imaging. A
  348.                frame device allocates storage for a complete raster output
  349.                page. The frame device was the only device type available in
  350.                the Level 1 psrip.
  351.  
  352.  
  353.      _b_a_n_d[,_n_u_m_B_u_f_f_e_r_s[,_m_e_m_L_i_m_i_t]]
  354.                Specifies that a band device be used. A band device renders the
  355.                output raster image as a series of sequential bands and thus
  356.                can use considerably less memory than a frame device. The back
  357.                end is passed bands as they are rendered. The RIP can do a
  358.                certain amount of parallel processing of bands and so the
  359.                numBuffers option can specify the number of band buffers to be
  360.                used. The default number of buffers is 1. The number of raster
  361.                lines per band is determined by the memLimit option. This
  362.                option specifies the total amount of memory that may be used
  363.                for all band buffers. The default memory limit is 5 MBytes.
  364.                memLimit is specified in number of bytes. Since the number of
  365.                scan line in a band must be a power of two, the actual memory
  366.                used for band buffers may differ from the specified memory
  367.                limit.
  368.  
  369.  
  370.      _a_u_t_o[,_n_u_m_B_u_f_f_e_r_s[,_m_e_m_L_i_m_i_t]]
  371.                Specifies that psrip should decide whether to use a frame
  372.                device or a band device. This is the default device type. The
  373.                decision is made based on the number of buffers to be used,
  374.                numBuffers, and the memory use limit, memLimit. The RIP starts
  375.                by assuming a frame device and calculates the amount of memory
  376.                required. If the total amount of memory required exceeds
  377.                memLimit, a band device is used. The band device is created
  378.                with numBuffers bands and a total memory limit of memLimit. The
  379.                default numBuffers is 1 and the default memLimit is 5
  380.                megabytes. The syntax for memLimit is the number of bytes.
  381.                Since the number of scan lines in a band must be a power of
  382.                two, the actual memory used for band buffers may differ from
  383.                the specified memory limit.  The 5 megabyte default memory
  384.                limit was chosen because it is enough to render an 8.5 by 11
  385.                inch page with 1-bit per color CMYK at 300 dpi using a frame
  386.                device.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  401.  
  402.  
  403.  
  404.      ----gggg _s_c_r_a_t_c_h_D_i_r
  405.                During execution the interpreter creates a scratch directory to
  406.                place a number of temporary files. The directory and its
  407.                contents are removed upon termination of _p_s_r_i_p. The ----gggg option
  408.                specifies the directory in which the scratch directory is to be
  409.                created.  The directory specified with the ----gggg option must exist
  410.                and is not created (scratch directories within the specified
  411.                directory are created). For example, if scratchDir is
  412.                /usr/foodir then psrip will create the scratch directory
  413.                /usr/foodir/uniqueDirName and place all temporary files in the
  414.                /usr/foodir/uniqueDirName directory. The directory
  415.                uniqueDirName and its contents will be removed by _p_s_r_i_p upon
  416.                termination.  If the ----gggg option is not specified, the default
  417.                scratch file directory is created in one of two locations. If
  418.                the environment variable PSRIPTMPDIR specifies a directory, the
  419.                scratch directory will be created in that
  420.                directory/<uniqueDirName>. If the variable is not set, the
  421.                directory will be created in the
  422.                /var/spool/lp/psparams/<uniqueDirName> directory. The
  423.                uniqueDirName is created in all cases. This is necessary as all
  424.                instances of the interpreter must have individual scratch
  425.                areas.
  426.  
  427.  
  428.      ----yyyy _p_e_r_s_i_s_t_e_n_t_D_i_r
  429.                The interpreter kernel caches persistent configuration
  430.                information in a number of disk files.  The ----yyyy option can be
  431.                used to specify an alternate persistent directory.  The
  432.                directory specifed with the ----yyyy option must exist (_p_s_r_i_p will
  433.                not create it). Persistent information is used by the
  434.                interpreter across invocations. For example, the total number
  435.                of pages output by the RIP (the PageCount parameter) is
  436.                maintained in a persistent file. By default persistent files
  437.                are created by the interpreter in one of two directories. If a
  438.                printer name has been specified (see ----PPPP option) and psrip is
  439.                being run as the lp user (based on euid), the persistent files
  440.                will be created in the directory
  441.                /var/spool/lp/psparams/<printerName>.  If a printer has not
  442.                been specified or the user is not lp, the persistent files will
  443.                be created in the scratch file directory (see ----gggg option) and
  444.                will be removed upon termination of the RIP. If the ----yyyy option
  445.                is specified, persistentfiles will be placed in the directory
  446.                persistentDir regardless of the user and regardless of whether
  447.                a printer has been specified.
  448.  
  449.  
  450.      ----aaaa _s_t_a_r_t_u_p_P_a_t_h
  451.                Specifies a search path for the directory containing the
  452.                startup.ps code and the POSTSCRIPT.VM initial VM file. The
  453.                search path is a colon separated list of directories. The path
  454.                is searched until each file is found. The default search path
  455.                is /usr/lib/print/data/psrip. If startupPath contains a path
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  467.  
  468.  
  469.  
  470.                consisting of the single character %, the default path will be
  471.                substituted. For example, if startupPath is specified as
  472.                %:/usr/people/foo the startup file search path will be
  473.                /usr/lib/print/data/psrip:/usr/people/foo.
  474.  
  475.  
  476.      ----bbbb _b_a_c_k_e_n_d_P_a_t_h
  477.                Specifies a search path for back end DSOs. All directories long
  478.                the path are searched until the required DSO is found. A back
  479.                end DSO is identified by a file ending in .so. The search path
  480.                is a colon separated list of directories. The default search
  481.                path is /usr/lib/print/psdevdso. If back endPath contains a
  482.                path consisting of the single character %, the default path
  483.                will be substituted. For example, if backendPath is specified
  484.                as %:/ usr/people/foo the back end DSO search path will be
  485.                /usr/lib/print/ psdevdso:/usr/people/foo. If DSOs along the
  486.                search path have the same name, the first DSO encountered will
  487.                be used.
  488.  
  489.  
  490.      ----cccc _r_e_s_o_u_r_c_e_P_a_t_h
  491.                Specifies a search path for interpreter resource files. All
  492.                directories along the path are searched for files ending in
  493.                .upr. The search path is a colon separated list of directories.
  494.                The default search path is /usr/lib/print/data/psrip.  If
  495.                resourcePath contains a path consist ing of the single
  496.                character %, the default path will be substituted. For example,
  497.                if resourcePath is specified as %:/usr/people/foo the resource
  498.                file search path will be
  499.                /usr/lib/print/data/psrip:/usr/people/foo.  Printer-specific
  500.                resource files can be read by adding their directory to
  501.                resourcePath.
  502.  
  503.  
  504.      ----oooo _b_a_c_k_e_n_d_O_p_t_i_o_n_s
  505.                This option is used to specify a string which will be passed to
  506.                the backend active during processing. The contents of the
  507.                backend option string is backend dependent. Basically, this
  508.                establishes a method of communication between the psrip user
  509.                and the backend.
  510.  
  511.  
  512.      ----kkkk        Normally, psrip outputs the raster image with the PostScript
  513.                origin on the trailing scan edge of the image. That is the
  514.                origin is on the last raster line of the image. The ----kkkk option
  515.                place the origin along the leading raster line. This option is
  516.                equivalent to the option ----rrrr _1_8_0.
  517.  
  518.  
  519.      ----vvvv        This option is used to color invert the output image. For
  520.                example, inverting an rgb image results in the red, green and
  521.                blue components replaced by cyan, magenta and yellow
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  533.  
  534.  
  535.  
  536.                respectively.
  537.  
  538.  
  539.      ----jjjj _p_i_x_e_l_s This option is used with xerographic engines. For a xerographic
  540.                marking engine, laser light illuminates spots on a
  541.                photosensitive medium that correspond to pixels of the raster
  542.                image. Different technologies illuminate either the spots that
  543.                correspond to colored pixels in the raster image - write-black
  544.                engines - or else illuminate the spots that correspond to
  545.                uncolored (white or blank) pixels in the raster image - write-
  546.                white engines. This option is for use with write-white engines.
  547.                The shapes of pixel marks on the medium are sufficiently
  548.                different between write-black and write-white marking engines
  549.                that special compensation must be made for the thinner shapes
  550.                produced by write-white engines. The pixels argument specifies
  551.                the number of pixels by which to fatten zero-width (one pixel)
  552.                lines so that they do not break up on write- white marking
  553.                engines. Specifying this option with a non-zero value of pixels
  554.                also disables both the ATM font rasterizer and Type 1 hinting.
  555.                Therefore, this option should only be used on write-white
  556.                marking engines for which the rendering artifacts are quite
  557.                pronounced and unsatisfactory.
  558.  
  559.  
  560.      ----xxxx        Specifies that psrip should run in executive (i.e. interactive)
  561.                mode. When run in this mode, the interpreter processes all
  562.                startup code but ignores any input page description file. The
  563.                interpreter accepts Post Script input at the PS> prompt. To
  564.                exit the interpreter type CTRL-D or quit. In order to capture
  565.                raster output the ----OOOO option must be specified. If ----OOOO is not
  566.                specified all raster output is sent to stdout.
  567.  
  568.  
  569.      ----EEEE        The ----EEEE switch, which provided backwards compatibility with the
  570.                pschunky program, has been removed.
  571.  
  572.      ----hhhh        Prints a program usage message to the standard error. This
  573.                usage message also lists the currently supported output
  574.                configurations.
  575.  
  576.      ----DDDD[[[[DDDD[[[[DDDD]]]]]]]]  Specifies verbose output for debugging purposes. There are
  577.                three levels of debugging information available.
  578.  
  579. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  580.      1.   The CHUNKY output formats _o_l_d_k, _o_l_d_c_m_y, and _o_l_d_c_m_y_k previously
  581.           provided by _p_s_r_i_p for compatibility with previous releases of the
  582.           _I_m_p_r_e_s_s_a_r_i_o product have been removed.
  583.  
  584.      2.   By default _p_s_r_i_p allocates memory for one complete output page. This
  585.           means that very large and/or high resolution output images require a
  586.           large amount of system memory. It is possible to specify an output
  587.           image that exceeds the virtual memory system's available memory swap
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  599.  
  600.  
  601.  
  602.           space. Refer to the _s_w_a_p(1M) man page for information on adjusting
  603.           system swap space.  Please note that the ----dddd option can be used to
  604.           invoke the interpreter in banding mode. This eliminates the memory
  605.           limitations resulting from large output images.
  606.  
  607.      3.   Under IRIX 5.2 there is a process size limit of 512 MBytes. The
  608.           process size limit can be increased by adjusting the values of the
  609.           _r_l_i_m_i_t parameters in the IRIX kernel configuration file
  610.           /_v_a_r/_s_y_s_g_e_n/_m_t_u_n_e/_k_e_r_n_e_l. Note that for a new kernel configuration
  611.           to take effect a new kernel must be built using the _a_u_t_o_c_o_n_f_i_g(1M)
  612.           program (the -_f switch must be specified). See the _m_t_u_n_e(4) and
  613.           _a_u_t_o_c_o_n_f_i_g(1M) man pages for reconfiguring and building a new IRIX
  614.           kernel.
  615.  
  616.  
  617. NNNNOOOOTTTTEEEESSSS
  618.      1.   The _p_s_r_i_p output file format is a TIFF compatible format called
  619.           Stream TIFF (STIFF). STIFF is a dialect of TIFF that can be read
  620.           from or written to non-seekable streams. The _p_s_r_i_p program will
  621.           write a printing specific form of STIFF. Refer to the _l_i_b_s_t_i_f_f(_3)
  622.           manual page for detailed information on the STIFF file format.
  623.  
  624.      2.   If _p_s_r_i_p is given an unrecognized or incomplete command line option
  625.           switch, it will print an error message to the standard error and
  626.           terminate the program. This differs from previous versions which
  627.           issued a warning and attempted to continue.
  628.  
  629.      3.   The level 2 _p_s_r_i_p ignores CCCCTTTTRRRRLLLL----DDDD and CCCCTTTTRRRRLLLL----ZZZZ characters in the
  630.           postscript data stream. A warning message indicating that one of the
  631.           above characters has been processed is logged, but no action is
  632.           taken.
  633.  
  634.      4.   The level 2 _p_s_r_i_p when invoked from _I_m_p_r_e_s_s_a_r_i_o product runs with
  635.           the user ID of "lp". Using the postscript file system it is possible
  636.           to access files, for reading and/or writing, which may otherwise be
  637.           inaccessible to any user other than "lp".
  638.  
  639.      5.   The level 2 _p_s_r_i_p contains a limit on image content. This image
  640.           content is defined as follows:
  641.  
  642.           Image Content = (Resolution * Bits Per Pixel * Number of Color
  643.           Planes) / 8
  644.  
  645.           Please note that the resolution represents the maximum of the x and
  646.           y resolutions. If the image content exceeds 600, _p_s_r_i_p will fail and
  647.           the program will terminate. At present, it is not possible to
  648.           acquire the license necessary to relax this restriction.  See the
  649.           Impressario Programming Guide for additional information.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. PPPPSSSSRRRRIIIIPPPP((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSRRRRIIIIPPPP((((1111))))
  665.  
  666.  
  667.  
  668. FILES
  669.      /usr/lib/print/psrip                   Program file
  670.      /usr/lib/print/data/psrip/Postscript.VM
  671.                                             Postscript VM file
  672.      /usr/lib/print/data/psrip/startup.ps   Startup code
  673.      /usr/lib/print/data/psrip              PostScript resource directory
  674.                                             (fonts, CRDs, etc.)
  675.      /usr/lib/print/psdevdso                Default directory containing
  676.                                             backend DSOs.
  677.      /var/spool/lp/psparams                 Default base directory for
  678.                                             persistent parameters and scratch
  679.                                             files.
  680.  
  681. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  682.      PostScript is a registered trademark of Adobe Systems, Inc.  Apple and
  683.      LaserWriter are registered trademarks of Apple Computer, Inc.
  684.  
  685. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  686.      sgi2ps(1), stiff2ps(1), libstiff(3), libpod(3), _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e
  687.      _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l - 2nd ed., Adobe Systems, Inc.
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.